Add GtkIconSize back to the docs

And document how it works now.

diff --git a/docs/reference/gtk/css-properties.xml b/docs/reference/gtk/css-properties.xml
index 81be2efb2275a70b8ec47f658f74a24ea9458fea..42837b07cc8eb784db405cb96e3c7b00924aa66a 100644 (file)
--- a/docs/reference/gtk/css-properties.xml
+++ b/docs/reference/gtk/css-properties.xml
@@ -569,7 +569,7 @@ We use <literallayout> for syntax productions, and each line is put in a <code>
               <entry>✓</entry>
               <entry></entry>
               <entry></entry>
-              <entry>Determines the size at which icons are displayed</entry>
+              <entry>Determines the size at which icons are displayed. See GtkIconSize</entry>
             </row>
           </tbody>
         </tgroup>

diff --git a/docs/reference/gtk/gtk4-sections.txt b/docs/reference/gtk/gtk4-sections.txt
index bea54de64331e60b1f0c486e609b1c96ff57ca71..9a25b3132be315c0e6a58a947ef0be6daeb7cd29 100644 (file)
--- a/docs/reference/gtk/gtk4-sections.txt
+++ b/docs/reference/gtk/gtk4-sections.txt
@@ -5300,6 +5300,7 @@ GtkShadowType
 GtkStateFlags
 GtkToolbarStyle
 GtkSortType
+GtkIconSize
 
 </SECTION>
 

diff --git a/gtk/gtkenums.h b/gtk/gtkenums.h
index a75429b8f9cd0abad3a23f8fdc46e181a4c1f9ea..81c20f1deccfa91155517bd96d9918ad48103d0d 100644 (file)
--- a/gtk/gtkenums.h
+++ b/gtk/gtkenums.h
@@ -183,6 +183,10 @@ typedef enum
  *
  * Icon sizes default to being inherited. Where they cannot be
  * inherited, text size is the default.
+ *
+ * All widgets which use GtkIconSize set the normal-icons or large-icons
+ * style classes correspondingly, and let themes determine the actual size
+ * to be used with the -gtk-icon-size CSS property.
  */
 typedef enum
 {